---
title: "AgentOS API Overview"
sidebarTitle: "Overview"
description: "Complete API reference for interacting with AgentOS programmatically"
---

Welcome to the comprehensive API reference for the Agno AgentOS API. This RESTful API enables you to programmatically interact with your AgentOS instance, manage agents, teams, and workflows, and integrate AgentOS capabilities into your applications.

## Authentication

AgentOS supports bearer-token authentication via a single Security Key.

- When `OS_SECURITY_KEY` environment variable is set on the server, all routes require:

```bash
Authorization: Bearer <OS_SECURITY_KEY>
```

- When `OS_SECURITY_KEY` is not set, authentication is disabled for that instance.

See the dedicated guide: [Secure your AgentOS with a Security Key](/agent-os/security).

## Core Resources

The AgentOS API is organized around several key resources:

<CardGroup cols={2}>
  <Card
    title="Agents"
    icon="robot"
    href="/reference-api/schema/agents/list-all-agents"
  >
    Create, manage, and execute individual agent runs with tools and knowledge
  </Card>
  <Card title="Teams" icon="users" href="/reference-api/schema/teams/list-all-teams">
    Orchestrate multiple agents working together on complex tasks
  </Card>
  <Card
    title="Workflows"
    icon="diagram-project"
    href="/reference-api/schema/workflows/list-all-workflows"
  >
    Define and execute multi-step automated processes
  </Card>
  <Card
    title="Sessions"
    icon="clock"
    href="/reference-api/schema/sessions/list-sessions"
  >
    Track conversation history and maintain context across interactions
  </Card>
  <Card
    title="Memory"
    icon="brain"
    href="/reference-api/schema/memory/list-memories"
  >
    Store and retrieve persistent memories for personalized interactions
  </Card>
  <Card
    title="Knowledge"
    icon="book"
    href="/reference-api/schema/knowledge/list-content"
  >
    Upload, manage, and query knowledge bases for your agents
  </Card>
  <Card
    title="Evals"
    icon="chart-bar"
    href="/reference-api/schema/evals/list-evaluation-runs"
  >
    Run evaluations and track performance metrics for your agents
  </Card>
</CardGroup>
